.\"   $Id: graal.1,v 1.2 2004/12/21 22:10:51 fred Exp $
.\" @(#)graal 1.07 94/10/10 UPMC/ASIM/LIP6/CAO-VLSI "
.TH GRAAL 1 "October 1, 1997" "ASIM/LIP6" "ALLIANCE Reference Manual"
.SH NAME
graal \- symbolic layout editor
.SH SYNOPSIS
.B graal
[\-l file_name]
[\-scale n]
[\-debug]
[\-xor]
[\-install]
      [\-force]
.br
.so man1/alc_origin.1
.SH DESCRIPTION
.B Graal
is a hierarchical symbolic layout editor. All functionnalities can be
accessed through different menus.
Among them exists a design rule checker performing verifications inside a
user defined window.
.B Graal
works under Motif and X11r6.
When entering 
.B Graal,
the main window appears and shows 7 different
menus on the top bar.These menus can be entered by simply clicking on the
mouse left button.
The main window is sensitive to the mouse, and the mouse wheel can be
used for scrolling up and down, left and right when <Shift> is pressed
during wheel movement, and zooming in and out, when <Ctrl> is pressed
while turning the wheel.

Below is given the description of graal's menus.

.TP 10
.B File
\f4New\fP : clean the entire window and save the current cell.
.br
\f4Open\fP : load an already existing cell.
.br
\f4Save\fP : save the current cell.
.br
\f4Save as\fP : rename and save the current cell.
.br
\f4Quit\fP : quit graal.

.TP 10
.B Edit
\f4Undo\fP : undo the previous action.
.br
\f4Copy\fP : copy a selected object.
.br
\f4Move\fP : move a selected object.
.br
\f4Delete\fP : delete a selected object.
.br
\f4Stretch\fP : strech a selected object (transistor or segment length).
.br
\f4Modify\fP : modify the caracteristics of an object (name, width,
etc...).
.br
\f4Identify\fP : identify a selected object.
.br
\f4Search\fP : search an object according to its type.

.TP 10
.B Window
This menu allows user to perform the same actions than the previous menu
Edit, not on an object but on a group of objects belonging to a defined
window.The two opposite corner of the window are set by clicking on the mouse 
left button.

.TP 10
.B Create
\f4Instance\fP : add a new instance in the current cell.
.br
\f4Abutmentbox\fP : define the abutment box of the current cell.
.br
\f4Segment\fP : add segments.
.br
\f4Via\fP : add vias or contacts.
.br
\f4Connector\fP : add connectors.
.br
\f4Transistor\fP : add transistors.
.br
\f4Reference\fP : add references.

.TP 10   
.B View
\f4Zoom\fP : perform zoom in, zoom out, center, fit, refresh on figure.
.br
\f4Layer\fP : select types of layers displayed.
.br
\f4Map\fP : show cursor position in the entire figure.
.br
\f4Arrows\fP : show arrows for moving at the grid step.
.br
\f4Grid\fP : Set the X,Y step of the grid if displayed.

.TP 10
.B Tools
\f4Equi\fP : highlight all objects electrically connected to a given object.
.br
\f4Flat\fP : virtual hierarchy flattening of an instance
(display all visible objects inside a given instance). 
.br
\f4UnFlat\fP : undo the virtual flattening of an instance
(done before with the Flat command)
.br
\f4Peek\fP : virtual hierarchy flattening 
(display all visible objects inside a given window). 
.br
\f4UnPeek\fP : undo the virtual flattening of a window
(done before with the Peek command)
.br
\f4Druc\fP : call the design rule checker in a given window.
.br
\f4RealFlat\fP : real hierarchy flattening of instances included in a window
(this command can not be undone, and should be used very carefully)
.br
\f4Hierarchy\fP : navigate into the current figure hierarchy
.br
\f4Load Error\fP : load a real layout file and superpose it to the current figure.
.br
\f4Message\fP : display the last error messages


.TP 10
.B Setup
Save or load a user defined configuration of default displayed menus.

.SH ENVIRONMENT VARIABLES
.TP
.B MBK_CATA_LIB
indicates the path to the read only libraries to be used. 
.TP
.B MBK_WORK_LIB
indicates the path to the read/write directory for the session.
.TP
.B MBK_IN_PH
indicates the file format to be used for the leaf cells.
.TP
.B MBK_OUT_PH
indicates the file format to be used for the generated figures.
.TP
.B GRAAL_TECHNO_NAME (optional)
indicates the path to the techno name file used by Graal.
.TP
.B RDS_TECHNO_NAME (optional)
indicates the path to the RDS configuration file used by Graal.

.SH SEE ALSO
mbk(1), MBK_CATA_LIB(1), MBK_IN_PH(1), MBK_OUT_PH(1), RDS_TECHNO_NAME(1)


.so man1/alc_bug_report.1

